A 



Installation Guide 



hp StorageWorks 
Business Copy EVA/MA/EMA 2.3 
Host Agent for Sun Solaris 

Product Version: 2.3 

Fifth Edition (September 2004) 
Part Number: T3032-96206 

The HP StorageWorks Business Copy (BC) for enterprise virtual array (EVA), modular array (MA), and 
enterprise modular array (EMA) installation guide describes procedures for installing, reinstalling, updating, 
and removing the BC host agent software. 



invent 



©Copyright 1999-2004 Hewlett-Packard Development Company, L.P. 

Hewlett-Packard Company makes no warranty of any kind with regard to this material, including, but not limited to, the implied 
warranties of merchantability and fitness for a particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for 
incidental or consequential damages in connection with the furnishing, performance, or use of this material. 

This document contains proprietary information, which is protected by copyright. No part of this document may be photocopied, 
reproduced, or translated into another language without the prior written consent of Hewlett-Packard. The information contained in this 
document is subject to change without notice. The only warranties for HP products and services are set forth in the express warranty 
statements accompanying such products and services. Nothing herein should be construed as constituting an additional warranty. HP 
shall not be liable for technical or editorial errors or omissions contained herein. 

Java is a U.S. trademark of Sun Microsystems, Inc. 

UNIX is a registered trademark of The Open Group. 

Hewlett-Packard Company shall not be liable for technical or editorial errors or omissions contained herein. The information is provided 
"as is" without warranty of any kind and is subject to change without notice. The warranties for Hewlett-Packard Company products are 
set forth in the express limited warranty statements for such products. Nothing herein should be construed as constituting an additional 
warranty. 



Business Copy EVA/MA/EMA 2.3 Host Agent for Sun Solaris Installation Guide 
Fifth Edition (September 2004) 
Part Number: T3032-96206 



contents 



About this Guide 5 

Overview 6 

Intended audience 6 

Prerequisites 6 

Conventions 7 

Document conventions 7 

Text symbols 7 

Getting help 8 

HP technical support 8 

HP storage web site 8 

HP authorized reseller 8 

1 Installation Preparation 9 

New installation preparation 10 

Coordinating Business Copy installation activities 10 

Verifying the Business Copy server configuration 10 

Verifying the host configuration 10 

Update installation preparation 12 

Downloading the update 12 

Backing up the update 12 

Coordinating Business Copy update activities 13 

Verifying the Business Copy server configuration 13 

Verifying the host configuration 13 

2 Installing the Business Copy Host Agent 15 

Preparing for installation 16 

CD-ROM method 16 

Web download method 16 

Starting the installation 17 

Command console installation method 17 

GUI installation 21 

Completing the installation 31 

Reusing customized OSVM.ini settings following a BC host agent update or reinstallation 31 

Manually starting and stopping the BC host agent 31 

Browsing to the Business Copy network 31 

Verifying that the Business Copy host agent is recognized 31 

System files modified during installation and removal 32 



Business Copy EVA/MA/EMA 2.3 Host Agent for Sun Solaris Installation Guide 



3 



Contents 



3 Reinstalling the Business Copy Host Agent 33 

4 Removing the Business Copy Host Agent 35 

Coordinating removal activities 36 

Starting the removal 37 

Command console removal method 37 

GUI removal method 38 

Completing the removal 40 

Glossary 41 

Index 43 

Figures 

1 Initiating the installation script 17 

2 License agreement 18 

3 BC prerequisites 18 

4 Installation folder option 19 

5 BC Server Platform Name 19 

6 Unsuccessful ping to BC server platform option 20 

7 Start BC Daemons 20 

8 Pre-Installation Summary 20 

9 Additional Information 21 

10 Installation Complete 21 

11 Introduction 22 

12 BC License Agreement 23 

13 BC Prerequisites 24 

14 Choose Install Folder 25 

15 BC Server Platform Name 26 

16 BC Server Platform Name failure message 27 

17 Start BC Daemons 27 

18 Pre-Installation Summary example 28 

19 Additional Information 29 

20 Install Complete 29 

2 1 BC package removal confirmation prompt 37 

22 BC removal status 37 

23 Uninstall Business Copy Host Agent 38 

24 Uninstall Business Copy host agent complete 39 

Tables 

1 Document conventions 7 



4 



Business Copy EVA/MA/EMA 2.3 Host Agent for Sun Solaris Installation Guide 



about this guide 



This installation guide supersedes previous Business Copy (BC) host agent installation guides 
and provides information to help you: 

■ Understand BC host agent installation prerequisites 

■ Install BC host agent for Sun Solaris software on a host computer in a BC network 

■ Update BC host agent software on a host computer 

■ Reinstall BC host agent software on a host computer 

■ Remove BC host agent software from a host computer 

■ Contact technical support for additional assistance 
"About this Guide" topics include: 

■ Overview, page 6 

■ Conventions, page 7 

■ Getting help, page 8 
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About this Guide 



Overview 

This section covers the following topics: 

■ Intended audience 

■ Prerequisites 

Intended audience 

This guide is intended for customers and HP authorized service providers. In addition to being 
familiar with BC, readers should also be knowledgeable of BC-supported: 

■ SAN fabric configurations 

■ Host operating system environments 

■ Storage systems 

■ Multibus configurations 

Prerequisites 

Before installing BC host agent software, consider the following items: 

■ Has the BC server software been installed on a BC server platform? 

If not, install the BC server software before continuing. Refer to the HP StorageWorks 
Business Copy EVA/MA/EM A v2.3 Getting Started Guide 1 (AA-RVHRA-TE) for 
prerequisite information and the HP StorageWorks Business Copy EVA/MA/EMA 2.3 
Server Installation Guide (T3032-96202) for the installation procedure. 

■ Does the host computer on which the BC host agent software is being installed have 
visibility to a BC server platform in the same SAN environment? If not, refer to the HP 
StorageWorks Business Copy EVA/MA/EMA 2.3 Network Administration Guide 2 
(T3032-96301). 
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1 . Hereafter referred to as BC Getting Started Guide. 

2. Hereafter referred to as BC Network Administration Guide. 
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Conventions 

Conventions consist of the following: 

■ Document conventions 

■ Text symbols 

Document conventions 



This document follows the conventions in Table 1. 
Table 1 : Document conventions 



Convention 


Element 


Blue text: Figure 1 


Cross-reference links 


Bold 


Menu items, buttons, and key, tab, and box 
names 


Italics 


Text emphasis and document titles in body text 


Monospace font 


User input, commands, code, file and 
directory names, and system responses (output 
and messages) 


Monospace, italic font 


Command-line and code variables 


Blue underlined sans serif font text 

(http://www.hp.com) 


Web site addresses 



Text symbols 

The following symbols may be found in the text of this guide. They have the following 
meanings: 



WARNING: Text set off in this manner indicates that failure to follow directions in the 
/ J \ warning could result in bodily harm or death. 



A Caution: Text set off in this manner indicates that failure to follow directions could result in 
damage to equipment or data. 



Tip: Text in a tip provides additional help to readers by providing nonessential or optional 
techniques, procedures, or shortcuts. 



Note: Text set off in this manner presents commentary, sidelights, or interesting points of 
information. 
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About this Guide 



Getting help 



If you still have a question after reading this guide, contact an HP authorized service provider 
or access our web site: http:/ / www.hp.com . 



HP technical support 



Telephone numbers for worldwide technical support are listed on the following HP web site: 
http://www.hp.com/ support/ . From this web site, select the country of origin. 



Note: For continuous quality improvement, calls may be recorded or monitored. 

Be sure to have the following information available before calling: 

■ Technical support registration number (if applicable) 

■ Product serial numbers 

■ Product model names and numbers 

■ Applicable error messages 

■ Operating system type and revision level 

■ Detailed, specific questions 



HP storage web site 



The HP web site has the latest information on this product, as well as the latest drivers. Access 
storage at: http://www.hp.com/ country/ us/eng/ prodserv/storage.html . From this web site, 
select the appropriate product or solution. 



HP authorized reseller 



For the name of your nearest HP authorized reseller: 

■ In the United States, call 1-800-345-1518 

■ In Canada, call 1-800-263-5868 

■ Elsewhere, see the HP web site for locations and telephone numbers: http:/ / www.hp.com . 
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Installation Preparation 



This chapter provides preparation information for installing or updating BC host agent 
software. Refer to the BC Getting Started Guide for prerequisite information before installing 
BC. 

Complete the applicable section before beginning a BC host agent software installation or 
update. 

■ New installation preparation, page 10 

■ Update installation preparation, page 12 



A Caution: Do not install the BC host agent before reviewing the BC server platform 
configuration. Installing BC in an unsupported configuration may cause the BC network to 
function improperly. For procedures on planning ana verifying BC supported configurations, 
refer to the BC Network Administration Guide. 
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Installation Preparation 



New installation preparation 

Complete the following procedures before installing BC: 

■ Coordinating Business Copy installation activities 

■ Verifying the Business Copy server configuration 

■ Verifying the host configuration 

Coordinating Business Copy installation activities 

Before installing BC, ensure that: 

■ The BC host agent installation activities have been coordinated with users of the host; 
coordinating with other users prevents a disruption in host activities 

■ The BC host agent version being installed is compatible with the BC server for this BC 
network 

■ The BC server that supports the BC host agent installation is installed or updated before 
installing the BC host agent 

■ The BC server is running while installing the BC host agent 



Note: HP strongly recommends that the BC server be running to allow the BC host agent installation 
software to establish communication with the BC server. If necessary, the BC host agent can be 
installed without the BC server running. 



Verifying the Business Copy server configuration 

Before installing the BC host agent, verify that the BC server: 

■ Has a version level that supports this host agent 

■ Remains running during the host agent update 

Also, record the following BC server platform information for the BC host agent installation: 

■ Fully qualified network name (such as MyComputer.dept.corp) 

■ Unqualified network name (such as MyComputer) 

■ IP address (such as 1 1.22.33.44) 

Make this information available during the BC host agent installation. 

To view the network name and IP address of a BC server platform, browse to the BC server 
platform and log in. Both items are shown at the top of the home page. 

When ready, go to the next section. 

Verifying the host configuration 

Before installing the BC host agent, verify that the host has BC-supported configurations and 
versions of the following: 

■ Host operating system version 

■ StorageWorks Solution Software kit 

■ FC HBAs and drivers 
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■ StorageWorks Secure Path 

■ Multibus failover configuration with the storage controllers 

This BC host agent is not cluster-aware and does not support clustering. 

Refer to the BC Network Administration Guide and HP StorageWorks Business Copy 
EVA/MA/EMA 2.3 Host Agent for Sun Solaris Release Notes 1 (T3032-98205) for specific 
requirements. 

When ready, go to "Installing the Business Copy Host Agent" on page 15 to start the 
installation. 



1 . Hereafter referred to as BC Host Agent Release Notes. 
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Installation Preparation 



Update installation preparation 

Complete the following procedures before updating to BC v2.3. 

■ Downloading the update 

■ Backing up the update 

■ Coordinating Business Copy update activities 

■ Verifying the Business Copy server configuration 

■ Verifying the host configuration 

Downloading the update 

The BC host agent update is available only by download from the Business Copy product page 
web site. 

1. Visit http://hl 8000. wwwl .hp.com/products/storage/software/bizcopyeva/index.html . 

2. Click software & drivers. 

3. Under technical support - hp Storage Works business copy eva, click the download 
software and drivers link. 

4. Under download software & drivers - specify product name, click the business copy 
upgrade ui eva v2.3 med/doc kit to access the update download page. 

5. Save the update to the host computer. 
When ready, go to the next section. 

Backing up the update 

After downloading the update file, HP recommends backing up the update file and the files 
extracted from the web site to CD-ROMs that you can keep in one or more locations. This 
ensures that BC installations and updates can be performed quickly in the future without 
downloading files again. 

HP recommends making the following CD-ROMs. 

■ One for archival puiposes 

■ One to keep with the BC server platform containing the BC server software 

■ One or more to retain with BC hosts 
To make a CD-ROM backup: 

1. Extract the individual files from the download file (BC_2 . 3_Update . exe). 
Do not extract deeper than the first level. 

2. Burn a CD-ROM copy of the download file and extracted files. 

3. Label each CD-ROM with the month and year. For example: 
"Business Copy v2.3 — September 2004 Update." 

When ready, go to the next section. 
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Coordinating Business Copy update activities 



A Caution: If not properly planned and coordinated, updating a BC host agent can result in 
reduced operational capabilities and failure of BC jobs. 



Before installing BC, ensure that: 

■ The BC host agent update activities have been coordinated with users of the host; 
coordinating with other users prevents a disruption in host activities 

■ The BC host agent version being updated is compatible with the BC server for this BC 
network 

■ No BC jobs involving the host are running or "undoing" or are scheduled to run or "undo" 
during the update installation period 

■ The BC server that supports the BC host agent installation is installed or updated before 
updating the BC host agent 

■ The BC server is running while updating the BC host agent 



Note: HP strongly recommends that the BC server be running to allow the BC host agent installation 
software to establish communication with the BC server. If necessary, the BC host agent can be 
installed without the BC server running. 



When ready, go to the next section. 

Verifying the Business Copy server configuration 

Before updating the BC host agent, verify that the BC server: 

■ Has a version level that supports this host agent 

■ Remains running during the host agent update 

Also, record the following BC server platform information for the BC host agent installation: 

■ Fully qualified network name (such as MyComputer.dept.coip) 

■ Unqualified network name (such as MyComputer) 

■ IP address (such as 1 1.22.33.44) 

Make sure to have this information available during the BC host agent installation. 

To view the network name and IP address of a BC server platform, browse to the BC server 
platform and log in. Both items are shown at the top of the home page. 

When ready, go to the next section. 

Verifying the host configuration 

Before updating the BC host agent, verify that the host has BC-supported configurations and 
versions of the following: 

■ Host operating system version 

■ Storage Works Solution Software kit 
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Installation Preparation 



■ FC HBAs and drivers 

■ Storage Works Secure Path 

■ Multibus failover configuration with the storage controllers 

This BC host agent is not cluster-aware and does not support clustering. 

Refer to the BC Network Administration Guide and BC Host Agent Release Notes for specific 
requirements. 

When ready, go to "Installing the Business Copy Host Agent" on page 15 to start the update. 
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Host Agent 




This module assumes that "Installation Preparation" on page 9 has been read and all 
appropriate steps have been successfully completed. Complete the following procedures, in 
sequence, to install a BC host agent: 

1. Preparing for installation, page 16 

2. Starting the installation, page 17 

3. Completing the installation, page 31 
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Installing the Business Copy Host Agent 



Preparing for installation 

Installation preparation involves one of two methods: CD-ROM or Web download. Use one of 
these methods to prepare for installing the BC host agent software. 

■ CD-ROM method 

■ Web download method 



Note: To install BC successfully, the host computer must have at least 60,063,369 bytes of free disk 
space. 



CD-ROM method 

1. Locate the BC host agent CD-ROM. 

2. On the host computer, open a terminal window and log on as a super-user. 

3. Insert the CD-ROM into the CD-ROM drive. 

4. Navigate to the Sun Solaris folder on the CD-ROM. 

The folder contains an executable file named bc_23_solaris_ha_install . bin. 

5. Copy the bc_23_solaris_ha_install.bin file to the host computer, if 
necessary. 

When ready, go to "Starting the installation" on page 17. 

Web download method 

1. On the host computer, open a terminal window and log on as a super-user. 

2. Locate either the CD-ROM made from the BC update download (see "Update installation 
preparation" on page 12) or the Sun Solaris download file 
(bc_23_solaris_ha_install .bin) on the host computer or LAN. 

3. Copy the bc_23_solaris_ha_install.bin file to the host computer, if 
necessary. 

4. On the host computer, navigate to the folder containing the 
bc_23_solaris_ha_install .bin file. 

When ready, go to the next section. 



16 



Business Copy EVA/MA/EMA 2.3 Host Agent for Sun Solaris Installation Guide 



Installing the Business Copy Host Agent 



Starting the installation 

BC provides two installation methods for Sun Solaris: command console and GUI. 

Command console installation method 

Complete the following procedure to install the BC host agent software. 

Note: During the installation procedure, press Enter to choose the default response. To return to a 
previous step, enter back. To exit the installation script at any time, enter quit. 

Press Enter as necessary to scroll through lengthy text screens. 

1. Enter sh . /bc_23_solaris_ha_install . bin to start the installation script. 

General information displays as the installation script unpacks, followed by BC-specific 
information. 

Note: Unpacking of the Java™ Runtime Environment (JRE) segment can take three to five minutes. 



Preparing to install. . . 

Extracting the JRE from the installer archive... 
Unpacking the JRE . . . 

Extracting the installation resources from the installer archive... 
Configuring the installer for this system's environment... 

Launching installer. . . 

Preparing CONSOLE Mode Installation. . . 
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PRESS <ENTER> TO CONTINUE: 

Figure 1 : Initiating the installation script 

2. Press Enter to continue. 



Business Copy EVA/MA/EMA 2.3 Host Agent for Sun Solaris Installation Guide 



17 



Installing the Business Copy Host Agent 



BC License Agreement 

Installation and use of Business Copy requires acceptance of the following License 
Agreement : 

Business Copy EVA/MA/EMA License Agreement 
Attention Notice 

IMPORTANT: READ CAREFULLY BEFORE USING THIS PRODUCT. 

DO YOU ACCEPT THE TERMS OF THIS LICENSE AGREEMENT? (Y/N) : 

Figure 2: License agreement 

3. Carefully review the BC license agreement. 

4. Enter y or yes to agree to these terms and continue the installation; enter n or no 
to exit the installation script. 

Entering yes provides a list of BC operational prerequisites. 



Note: HP recommends exiting the installation if BC prerequisites have not been met, or if doubts 
exist as to whether the requirements are met. Take the necessary action to make sure that these 
prerequisites are met and then restart the installation. 





BC Prerequisites 




Welcome to the HP StorageWorks 
This script will install BC on 


Business Copy EVA/MA/EMA Host Agent installation script, 
this computer. 


Do not proceed until you have: 




PRESS <ENTER> TO CONTINUE: 





Figure 3: BC prerequisites 



A Caution: Failure to properly address BC pre-installation requirements and compatibility 
considerations can lead to reduced operational capability and failure of BC jobs. 



5. Press Enter to continue; enter quit to exit the installation script. 
An option to select the BC installation folder displays. 

■ For initial installations, /opt displays as the BC default installation folder. 

■ For reinstallations, the folder used during the previous installation displays as the 
default installation folder. 
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Caution: HP does not recommend changing the installation folder when reinstalling the BC 
host agent. Changing the folder during a BC host agent reinstallation might cause BC to 
function improperly. 



Choose the Installation Folder 

CPQevm will be appended to the base directory selected. 
Where would you like to install Business Copy? 
Default Install Folder: </opt/> 

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT 



Figure 4: Installation folder option 



Note: If updating BC host agent software, the update automatically uses the initial BC installation 
folder. 



6. Press Enter to continue using the BC default installation folder or enter an absolute path 
to the desired installation folder; enter quit to exit the installation script. 

Initially, a progress bar is displayed, followed by a BC server platform name question. 
Note: For reinstallations, the previous BC server platform name displays as the default. 



BC Server Platform Name 

Enter the BC server platform fully qualified name, unqualified name, or IP address: 
BC server platform Name (DEFAULT: <BC_server_platform_name/IP>) : 

Figure 5: BC Server Platform Name 

7. Enter the fully qualified name, unqualified name, or IP address of the BC server platform 
that supports this BC host agent. 

Note: The BC server platform name or IP address is required to establish network communication 
between BC host agents and the BC server. 



Note: HP recommends using the fully qualified name when entering BC server platform name 
information. 
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Installing the Business Copy Host Agent 



After entering the BC server platform name or IP address, a check is performed to verify 
communication. This check allows an incorrect BC server platform name to be corrected 
and provides the opportunity to continue the BC host agent installation in the event that the 
LAN is down or the BC server platform is offline. 



■ If this check fails, Figure 


6 displays. 




Unable to Ping Host 




Unable to ping the BC server platform on 
name to the sb.ini file at a later date, 
and continue the installation? 


this network. You can add the BC server platform 
Do you want to keep this BC server platform name 


->1- Yes 
2- No 




ENTER THE NUMBER OF THE DESIRED CHOICE, 


OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 



Figure 6: Unsuccessful ping to BC server platform option 

— Entering a 1 or pressing Enter continues the installation using the BC server 
platform name entered. 

— Entering a 2 displays Figure 5, continue with step 7. 
■ If this check succeeds, Figure 7 displays. 



Start BC Daemons 



Would you like to start the BC Daemons after the installation is complete? If you are 
unsure as to whether or not to start the BC Daemons after the installation, please refer 
to the BC Network Administration Guide. 

->1- Yes 
2- No 

ENTER THE NUMBER OF THE DESIRED CHOICE, OR PRESS <ENTER> TO ACCEPT THE DEFAULT: 

Figure 7: Start BC Daemons 

8. Enter 1 or press Enter to start the BC daemons after the installation is complete; enter 2 
to prevent the BC daemons from starting after the installation is complete. 

Pre-Installation Summary 



Please review the following before continuing: 

Product Name: 

Business Copy EVA/MA/EMA Host Agent v2 . 3 

Install Folder: 

selected_f older or /opt/CPQevm 

BC Server Platform: 

<BC_server_platform_name/IP> 

Disk Space Information (for Installation Target) : 
Required: 61,183,234 bytes 
Available: 123,456,789 bytes 

PRESS <ENTER> TO CONTINUE: 

Figure 8: Pre-Installation Summary 
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9. Press Enter to continue; enter quit to exit the installation if the pre-installation 
information is incorrect. 

The BC host agent software installation takes place. 

Additional Information 

To reinstall or remove the Business Copy software from this host computer, refer to the 
BC Host Agent Installation Guide. 

Please consult the BC Host Agent Release Notes before using Business Copy. 
To submit comments regarding BC, send an email to BCFeedback@hp.com. 
PRESS <ENTER> TO CONTINUE: 

Figure 9: Additional Information 

10. Carefully review the Additional Information provided. 

1 1 . Press Enter to continue. 



Installation Complete 

Congratulations. Business Copy EVA/MA/EMA Host Agent v2 . 3 has been successfully 
installed to: 

<BC_default or selected_folder> 

PRESS <ENTER> TO EXIT THE INSTALLER: 

Figure 10: Installation Complete 

12. Press Enter to complete the installation. 

The BC host agent software is installed. This new BC-enabled host can now communicate 
with the BC server and participate in BC jobs. Refer to the BC Host Agent Release Notes 
before using BC. 

GUI installation 

Complete the following procedure to install the BC host agent software. 



Note: If installing BC in GUI mode, set the host computer color depth to at least 256 colors. 



Note: Do not remove the BC host agent CD-ROM from the CD drive until the installation is complete. 
Removing the CD-ROM before the installation is complete may cause the installation to fail or BC to 
function improperly. 



1. Enter . /bc_23_solaris_install . bin -i gui to start the installation. 
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£C Business Copy EVA/MA/EMA Host Agent v2.3 



" Introduction 
■ BC License AQreemetf 
BC Prerequisites 
Choose the Installation 
BC Server Platform Name 
Pre-lnstaJlation Summary 
Installing 

Additional Information 
Installation Complete 




InstallAnywhere by Zero G 



_ 



Cancel 



Introduction 



InstallAnvwhere will guide you through the installation of HP 
StorageWorks Business Copy(BC). 

HP strongly recommends that you use an account with 
"super-user" or "administrator" privileges before executing this 
installation script. If you are not logged in as root, quit this install, 
log into the root account and execute this installation script again. 

It is strongly recommended that you quit all programs before 
continuing with this installation. 

Click the 'Next' button to proceed to the next screen. If you want 
to change something on a previous screen, click the 'Previous' 
button. 

You may cancel this installation at anytime by clicking the 'Cancel' 
button. 



Previous 



Next 



Figure 1 1 : Introduction 

2. Click Next. 



Note: Click Cancel at any time to exit the installation. 



3. Carefully review the BC License Agreement before continuing with the installation. 
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jC Business Copy EVA/MA/EMA Host Agent v2.3 



Introduction 
n BC License Agreement 

■ BC Prerequisites 

■ Choose 'lie h spallation 



■ BC SaftSBi Platform Name 

■ Pre-lnstallaiiuti Summary 

■ Installing 

■ Additional I nr or in an on 



Installation Complete 




InstallAnywhere by Zero C 



Cancel 



BC License Agreement 



Installation and use of Business Copy requires acceptance of the 
following License Agreement 



Business Copy EVA/MA/EMA License Agreement 
Attention Notice 

IMPORTANT: READ CAREFULLY BEFORE USING THIS 
PRODUCT. 

USE OF THE SOFTWARE IS SUBJECT TO THE 
HEWLETT-PACKARD COMPANY (''HP") SOFTWARE LICENSE 
TERMS SET FORTH BELOW. USE OF THE SOFTWARE 
INDICATES YOUR ACCEPTANCE OF THESE LICENSE TERMS. 
IF YOU DO NOT ACCEPT THESE LICENSE TERMS, YOU MUST 
NOT INSTALL THE SOFTWARE. 

DEFINITIONS 

11 "Software" means one or more programs capable of 



>.*) I accept the term s of the License Agreem ent 

I do NOT accept the term s of the License Agreem ent 



Previous 



Next 



Figure 1 2: BC License Agreement 



Note: To continue installing the BC host agent software, the terms in the agreement must be 
accepted. 



4. Click I accept the terms of the License Agreement to continue the installation. 

5. Click Next. 

Review the prerequisites and become familiar with each one. This window provides a 
reminder of items to verify or perform before continuing the BC host agent installation. 
Refer to the BC Getting Started Guide for detailed prerequisite information. 



Note: HP recommends exiting the installation if BC prerequisites have not been met or doubts exist 
as to whether the prerequisites are met. Take the necessary action to make sure that the prerequisites 
are met and restart the installation. 
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;C Business Copy EVA/MA/EMA Host Agent v2.3 
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■ Choose the Installation ... 

■ BG Server Platform Name 

■ P re-Installation Summary 

■ Installing... 

■ Additional Information 
I Installation Complete 




InstallAnywhere by Zero G 



BC Prerequisites 



Welcome to the HP StorageWorks Business Copy 
EVA/MA/EMA Host Agent installation script. This script will 
install BC on this computer. 

Do not proceed until you have: 

- Read the HP StorageWorks BC Getting Started Guide, BC 
Network Administration Guide, BC Server Installation Guide, 
BC Host Agent Installation Guide, BC Server Release Notes, 
and BC Host Agent Release Notes. 

- Addressed all BC preinstallation requirements and 
compatibility considerations. 

Typical items to address before installing a BC host agent 
include: 

- Host Operating System Version 

- StorageWorks Solution Software Kit Version 

- Fibre Channel Host Bus Adapters (HBA) and Driver versions 

- ^+*-.ran^W*-.rlre ^r-nre Path W^rei*-.n 



Previous 



Next 



Figure 13: BC Prerequisites 



A Caution: Failure to properly address BC preinstallation requirements and compatibility 
considerations can lead to reduced operational capability and failure of BC jobs. 



6. If the prerequisites are met, click Next. 



A Caution: HP does not recommend changing the installation folder when reinstalling the BC 
host agent. Changing the folder during a BC host agent reinstallation might cause BC to 
function improperly. 
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g Business Copy EVA/MA/EMA Host Agent v2.3 



lS|x] 



~* Introduction 
BC License Agreement 
BC Prerequisites 
n Choose the Installation ... 

BC Server Platform Name 
Pre-lnstallatlon Summary 
Installing 

Additional Information 
installation Complete 




InstallAnywhere by Zero C ■ 



_ 



Cancel 



Choose the Installation Folder 



CPQevtn will be appended to the base directory selected. 



Where would you like to install Business Copy? 



Previous 



/opt 




Restore Default Folder 


Choose... 



Next 



Figure 14: Choose Install Folder 



Note: If updating BC host agent software, the update automatically uses the initial BC installation 
folder. 



7. Click Next if the default destination folder is acceptable; otherwise, click Choose to 
browse to another installation folder and then click Next. 
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BC Server Platform Name 



" Introduction 

BC License Agreement 

BC Prerequisites 

Choose the Installation ... 
B BC Server Platform Name 

■ P re - 1 n si al I at i o r . Si i rn rn ary 

■ dialling 

■ Additional Informalion 



Installation Complete 




Enter the BC Server Platform fully qualified name, unqualified 
name, or IP address: 



BC Server Platform Name 




InstallAnywhere by Zero G ■ 



Cancel 



Previous 



Next 



Figure 1 5: BC Server Platform Name 



Note: For reinstallations, the previous BC server platform name displays as the default. 



8. Enter the fully qualified name, unqualified name, or IP address of the BC server platform 
that supports this BC host agent. 



Note: The BC server platform name is required to establish network communication between this BC 
host agent and the BC server. 



9. Click Next. 

A check is performed to verify communication. This check allows an incorrect BC server 
platform name to be corrected and also provides the opportunity to continue the BC host 
agent installation in the event that the LAN is down or the BC server platform is offline. 

■ If this check fails, Figure 16 displays. 
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jC Warning 




Unable to Ping Host 



Unable to ping the Storage Management Appliance on the 
network. You can add the Storage Management Appliance name 
to the sb.ini file at a later date. Do you want to keep this Storage 
Management Appliance name and continue the installation? 



No 



Yes 



Figure 16: BC Server Platform Name failure message 

— Click Yes to continue the installation using the BC server platform name entered 
in step 8. 

— Click No to display Figure 15 and continue the installation at step 8. 
■ If this check succeeds, Figure 17 displays. 



jC Start BC Daemons 




Start BC Daemons 

Would you like to start the EC Daemons afterthe installation is 
complete? If you are unsure as to whether or not to start the EC 
Daemons afterthe installation, please referto the EC Network 
Administration Guide. 



No 



Yes 



Figure 1 7: Start BC Daemons 

10. Click Yes to start BC daemons; click No to defer BC daemons. 
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~* Introduction 

BC License Agreement 
BC Prerequisites 
Choose the Installation ... 
BC Server Platform Name 
n Pre-lnstallation Summary 

■ w stalling 

I Additional Information 



Installation Complete 




InstallAnywhere by Zero G ■ 



_ 



Cancel 



Pre-lnstallation Summary 



Please Review the Following Before Continuing: 



Product Name: 

Business Copy EVA/MA/EMA Host Agent v2.3 

Install Folder 

/opt/CPQevrn 

BC Server Platform: 

16.112.40.186 

Disk Space Information (for Installation Target): 

Required: 49,130,527 bytes 
Available: 122, 183,680 bytes 



Previous 



Install 



Figure 18: Pre-lnstallation Summary example 

11. If the pre-installation summary information is: 

■ Correct, click Install. 

■ Not correct, click Previous or Cancel. 

An installation progress window briefly displays as the BC host agent software installs. 
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Additional Information 



° Introduction 

BC License Agreement 
BC Prerequisites 
Choose the Installation ... 
BC Server Platform Name 
Pre-lnstallation Summary 
Installing... 
B Additional Information 
Installation Complete 



To reinstall or remove the Business Copy software from this host 
computer, refer to the BC Host Agent Installation Guide. 

Please consult the BC Host Agent Release Notes before using 
Business Copy. 

To submit comments regarding BC, send an email to 
BCFeedback@hp.com 



InstallArywhere by Zero G ■ 



_ 



Cancel 



Previous 



Next 



Figure 19: Additional Information 

12. Click Next after reviewing the additional information. 
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Installation Complete 



f Introduction 

P BC License Agreement 

" BC Prerequisites 

l ~' Choose the Installation ... 

F* Storage Management P... 

t_ ' Pre-lnstallation Summary 

Installing... 
f Additional Information 
Installation Complete 



Congratulations! Business Copy EVA/MA/EMA Host Agent v2.3 
has been successfully installed to: 

/opt/CPQevm 

Press "Done" to quit the installer. 



InstallAnywhene by Zero G 



Previous 



Done; 



Figure 20: Install Complete 
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13. Click Done. 

The BC host agent software is installed. This new BC-enabled host can now communicate 
with the BC server and participate in BC jobs. Refer to the BC Host Agent Release Notes 
before using BC. 
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Completing the installation 



If the BC host agent was started during installation, HP recommends browsing to the BC 
network and verifying that the BC host agent has been recognized. Otherwise, perform the 
verification after manually starting the host agent. 

Completing the installation topics include: 

■ Reusing customized OSVM.ini settings following a BC host agent update or reinstallation 

■ Manually starting and stopping the BC host agent 

■ Browsing to the Business Copy network 

■ Verifying that the Business Copy host agent is recognized 

■ System files modified during installation and removal 



Reusing customized OSVM.ini settings following a BC host agent update or 
reinstallation 

If an existing BC network used customized settings in the OSVM . ini file, these customized 
attributes can be reapplied following a BC host agent update or reinstallation. 



Note: During the BC host agent installation, the previous SB. ini file is automatically updated 
with changes required for BC v2.3 operations. 



During the BC host agent installation, the previous OSVM . ini file is saved as 
OSVM . ini . bak to allow access to the previous customized settings. If desired, reapply the 
customized settings by migrating them from the OSVM . ini . bak file to the new 
OSVM.ini file. 



Refer to the BC Network Administration Guide for the procedures to manually start or stop the 
daemons on a BC host agent. 



To browse to the BC network, the browsing computer must have a BC-supported browser with 
a JRE installed. 

Refer to the BC Network Administration Guide and HP StorageWorks Business Copy 
EVA/MA/EMA 2.3 Server Release Notes (T3032-98201) for details. 



To verify that a BC host agent is being recognized by the BC server platform, complete the 
following procedure: 

1, Browse to and log in to the BC server platform. 

The BC GUI displays. Refer to the BC Network Administration Guide, if necessary, to 
access the BC GUI. 

2. Click Help. 



Manually starting and stopping the BC host agent 



Browsing to the Business Copy network 



Verifying that 



the Business Copy host agent is recognized 
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3. Click About Business Copy. 

Verify that the BC version number is 2.3. 

4. Click Resources. 

5. Review the Resources page to verify that the host is included in the host resources display. 
A successful installation displays the BC host agent on this page. 

6. Continue to the next host-specific BC Host Agent Installation Guide to add other BC host 
agents to this BC network or to update existing agents. 

System files modified during installation and removal 

During BC host agent installation, the following host system file is modified: 

/etc/services. 

S ample entries added to the /etc/services file include : 

switchboard 4991/tcp #CPQevm switchboard application 
bdctrcv 4995/udp #CPQevm broadcast receiver application 

During the BC host agent removal process, this file is modified again to remove the BC entries 
added during the installation process. 
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Reinstalling the Business Copy 
Host Agent 



Situations may arise where a change in the BC network requires a change to BC server 
information stored by the BC host agent. For example: 

■ The BC server platform is renamed or replaced. 

■ The BC server platform IP address changes. 

■ The BC server software is moved to a different BC server platform. 

■ A network name changes. 

■ A host computer is reassigned for use with a different BC server platform. 
For these situations, reinstalling the BC host agent may be appropriate. 



A Caution: Make sure that all personnel involved with using storage systems associated with 
this BC environment are informed of the impending BC reinstallation. If not properly 
planned and coordinated, reinstalling a BC host agent while the host agent is involved in 
running a BC job can result in reduced operational capabilities and loss of data. 



Two reinstallation methods exist: 

■ One-step reinstallation — With this method, reinstall the BC host agent using "Installing 
the Business Copy Host Agent" on page 15. When prompted, allow the installation script 
to remove the existing host agent, and then install the BC host agent. 

■ Two-step reinstallation — With this method, remove the BC host agent using "Removing 
the Business Copy Host Agent" on page 35. Then reinstall the BC host agent using the 
procedure in "Installing the Business Copy Host Agent" on page 15. 
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Removing the Business Copy 
Host Agent 




Removing BC host agent software involves the following major steps: 

1. Coordinating removal activities, page 36 

2. Starting the removal, page 37 

3. Completing the removal, page 40 
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Coordinating removal activities 

Removing a BC host agent requires coordination to make sure that the software is removed 
cleanly from the host. 



A Caution: Make sure that all personnel using storage systems associated with this BC 
environment are informed of the impending BC removal. Removing a BC host agent while 
the host agent is running a BC job can result in reduced operational capabilities and loss of 
data. 



Ensure that: 

■ No BC jobs that involve the host are running or "undoing" during the removal 

■ No BC jobs that involve the host are scheduled to run or "undo" during the removal 

■ Removal activities have been coordinated with BC users and other operations 
Be aware that: 

■ Stopping a BC host agent prevents the host computer from being recognized by the BC 
network 

■ Stopping a BC host agent prevents any jobs involving that host from running successfully 
When ready, go to the next section. 
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Starting the removal 

BC provides two removal methods for Sun Solaris: command console and GUI. 

Command console removal method 

Complete the following procedure to remove the BC host agent software from a host. 
Note: During the removal procedure, press Enter to choose the default response. 

1. Open a terminal window and log on as a super-user. 

2. Change the working folder to the one containing the BC host agent. 

For example, the default installation folder is ... /opt/CPQevm/bin. 

3. Enter . /delete, sh to initiate the removal script. 

Business Copy daemons stopped. 



The following package is currently installed: 

CPQevm HP StorageWorks Business Copy Host Agent 

(SPARC) 2.3.0.0 

Do you want to remove this package? 

Figure 21: BC package removal confirmation prompt 

4. Press Enter (or enter y) to confirm the BC package removal; enter n to exit the removal 
script. 

##Removing installed package instance of <CPQevm> 
##Processing package information. 
##Removing pathnames in class <none> 



Removal of <CPQevm> was successful. 



Uninstalling . . . 



Uninstall Complete 



All items were successfully uninstalled 

Figure 22: BC removal status 

The command prompt returns when the BC host agent removal is complete. 
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GUI removal method 

Complete the following procedure to remove the BC host agent from a host. 

1. On the host computer, open a terminal window and log on as a super-user. 

2. Enter . /delete, sh gui to initiate the removal. 



Note: Click Cancel at any time to exit setup. 



Uninstaii Business Copy EVA/MA/EMA Host Agent v2.3 



[□I.*! 



^ Introduction 

Uninst ailing 
Uninstaii Complete 



Uninstaii Business Copy EVA/MA/EMA Host Agent v2.3 



InstalLAnywhere by Zero C 



_ 



Cancel 



About to uninstaii... 

Business Copy EVA/MA/EMA Host Agent v2.3 

This will remove features installed by InstalLAnywhere. It will not 
remove files and folders created after the installation. 



Previous 



Uninstaii 



Figure 23: Uninstaii Business Copy Host Agent 

3. Click Uninstaii to uninstaii the BC host agent software from the host. 

A Setup Status window is briefly displayed during the removal of BC files. File removal 
can take anywhere from a few seconds to several minutes. No action is required. 
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£? Uninstall Business Copy EVA/MA/EMA Host Agent 



JSJxJ 



Uninstall Business Copy EVA/MA/EMA Host Agent v2.3 



Introduction 
f" 1 Uninstalling... 
R Uninstall Complete 



All items were successfully uninstalled. 



InstallAnywhene by Zero G 



Ca ncel 



P revious 



Done 



Figure 24: Uninstall Business Copy host agent complete 

4. Click Done to exit setup. 

The BC host agent is now removed from this host computer. 
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Completing the removal 

After the BC host agent is removed, the computer can no longer participate in BC jobs. 
Running any BC job that involves this computer causes the job to fail. 

HP recommends planning for the disposition of each BC job that involves this computer. For 
example: 

■ Delete the job (if the job will not be valid again). 

■ Change the job (to eliminate all references to this host computer). 

■ Leave the job as is (if the job might be used again). 

From a BC network perspective, a BC host agent removal is not complete until all impacted 
BC jobs are resolved. 
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This glossary defines terms that are used in this guide or are related to BC. 

BC environment 

A SAN environment in which Business Copy replication features are available. BC features can be available 
through various means, such as: storage managers, BC server and jobs, BC host agents, command line 
interfaces, and script files. 

BC network 

The portion of a SAN that consists of a BC server connected via LAN to BC-enabled host computers. 
BC server platform 

An SMA or SMS with BC server software installed. 

See also Storage Management Appliance and Storage Management Server. 

daemon 

Diagnostic and Execution Monitor. Pronounced "demon." A program usually associated with a UNIX® system 
that performs a utility (housekeeping or maintenance) function without being requested or even known by the 
user. 

host 

In networked storage, a computer that can perform I/O with a storage array. In general networking, any 
computer on a network that provides a service. 

host agent 

In a client/server system, a program that performs information gathering or processes tasks on behalf of a client 
or server. Agents often communicate with other agents to perform a collective task on behalf of the user. 

host, BC-enabled 

A host computer that has BC host agent software installed. Compare to standard host, 
instance 

The presence of a program or set of related programs in a computer or storage system, 
job (BC job) 

A file created by BC that represents a user request to perform a task or series of tasks. For example, the BC job 
named sales_daily_backup might: 

1. Replicate virtual disks to create BCVs. 

2. Mount the BCV on a server. 

3. Start the tape backup of the BCV. Jobs can be created and run from the GUI, the BC command line 
(EVMCL), script files, or a scheduler. 
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Open View 

An HP line of software products that provides storage management solutions, data protection and recovery, 
automatic performance tuning, storage virtualization, and other features for multivendor storage environments. 

SAN 

Storage Area Network. A dedicated, high-speed network of storage devices that are available to servers on a 
LAN or WAN. As storage devices are added to the SAN, they become accessible to the servers in the larger 
network. 

server 

A computer or program that provides a service to other computers in a client/server system. Servers often run 
continuously, waiting for requests from clients. 

SMA 

See Storage Management Appliance. 
SMS 

See Storage Management Server, 
storage manager 

A Web-based storage environment manager that enables a user to configure and monitor MA/EMA or EVA 
controllers. The HSG Element Manager resides on the Storage Management Appliance (SMA); Command View 
EVA resides on the BC server platform. 

Storage Management Appliance 

SMA. A host-independent server product designed to connect directly to the SAN fabric. The SMA provides a 
centralized point for managing and monitoring SAN elements, including HP switches and storage arrays. SMA 
software installed on the appliance provides a GUI interface for accessing the monitored SAN environment. The 
SMA software also provides a launch site for a variety of value-added HP OpenView applications and provides 
navigation links to directly manage storage components on the SAN. 

Storage Management Server 

SMS. Any HP supported hardware-software platform that is not connected to the SAN fabric and that does not 
serve as a storage host. SMS software installed on a platform provides a GUI interface for accessing the 
monitored SAN environment. 

StorageWorks 

An HP line of hardware and software storage solutions that provides storage management solutions, data 
protection and recovery, automatic performance tuning, storage virtualization, and other features for 
multivendor storage environments. 

unit (MA/EMA only) 

In StorageWorks storage systems, an identifier that the controller uses when a container is mounted on a host 
computer. For example, the unit identifier DI could represent a RAID 0+ 1 striped mirror set that is mounted on a 
host computer. StorageWorks disk units begin with the letter D and tape units begin with the letter T. 

virtual disk (EVA only) 

In StorageWorks storage systems, a simulated disk that is created from physical disks in a storage array for use 
by hosts. 
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